home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_300 / 350_01 / pcx_int.h < prev    next >
Encoding:
C/C++ Source or Header  |  1991-11-29  |  10.7 KB  |  197 lines
  1. /* 
  2.  *************************************************************************
  3.  *
  4.  *  PCX_INT.H - PCX_LIB Library Internal Definitions Include File
  5.  *
  6.  *  Version:    1.00C
  7.  *
  8.  *  History:    91/02/14 - Created
  9.  *              91/04/01 - Release 1.00A
  10.  *              91/04/07 - Release 1.00B
  11.  *              91/12/01 - Release 1.00C
  12.  *
  13.  *  Compiler:   Microsoft C V6.0
  14.  *
  15.  *  Author:     Ian Ashdown, P.Eng.
  16.  *              byHeart Software
  17.  *              620 Ballantree Road
  18.  *              West Vancouver, B.C.
  19.  *              Canada V7S 1W3
  20.  *              Tel. (604) 922-6148
  21.  *              Fax. (604) 987-7621
  22.  *
  23.  *  Copyright:  Public Domain
  24.  *
  25.  *************************************************************************
  26.  */
  27.  
  28. /*      DEFINITIONS                                                     */
  29.  
  30. #define _PCX_INT_H      1
  31.  
  32. #ifndef _PCX_EXT_H
  33. #include "PCX_EXT.H"    /* Get external PCX definitions, etc.           */
  34. #endif
  35.  
  36. #define PCX_HERC        0xff    /* Hercules 720 x 348 monochrome mode   */
  37.  
  38. #define PCX_COMP_FLAG   0xc0    /* Compressed data flag mask            */
  39. #define PCX_COMP_MASK   0x3f    /* Data repeat count mask               */
  40.  
  41. #define PCX_PAL_MASK    0x03    /* Palette interpretation mask          */
  42. #define PCX_EPAL_FLAG   0x0c    /* Extended palette flag                */
  43.  
  44. #define PCX_PAL_SIZE    16      /* File header palette size             */
  45. #define PCX_EPAL_SIZE   256     /* Extended palette size                */
  46.  
  47. #define PCX_MAXLINESZ   640     /* Maximum PCX line buffer size         */
  48.  
  49. /* Color graphics adapter color palette macros                          */
  50.  
  51. #define PCX_CGA_BKGND(x)        (x[0].red >> 4)    /* Background color  */
  52. #define PCX_CGA_BURST(x)        (x[1].red & 0x80)  /* Color burst       */
  53. #define PCX_CGA_SELECT(x)       (x[1].red & 0x40)  /* Palette selector  */
  54. #define PCX_CGA_INTENSITY(x)    (x[1].red & 0x20)  /* Intensity         */
  55.  
  56. typedef unsigned char BYTE;     /* 8-bit data type                      */
  57. typedef unsigned int WORD;      /* 16-bit data type                     */
  58.  
  59. /*      STRUCTURE DECLARATIONS                                          */
  60.  
  61. typedef struct pcx_pal  /* PCX palette array element                    */
  62. {
  63.   BYTE red;             /* Red intensity                                */
  64.   BYTE green;           /* Green intensity                              */
  65.   BYTE blue;            /* Blue intensity                               */
  66. }
  67. PCX_PAL;
  68.  
  69. typedef struct pcx_hdr  /* PCX file header (Version 5)                  */
  70. {
  71.   BYTE pcx_id;          /* Always 0x0a for PCX files                    */
  72.   BYTE version;         /* Version number                               */
  73.   BYTE encoding;        /* 1 = PCX run length encoding                  */
  74.   BYTE bppixel;         /* Number of bits/pixel per color plane         */
  75.   WORD xul;             /* X-position of upper left corner              */
  76.   WORD yul;             /* Y-position of upper left corner              */
  77.   WORD xlr;             /* X-position of lower right corner             */
  78.   WORD ylr;             /* Y-position of lower right corner             */
  79.   WORD horz_res;        /* Horizontal resolution                        */
  80.   WORD vert_res;        /* Vertical resolution                          */
  81.   PCX_PAL palette[PCX_PAL_SIZE];        /* Hardware R-G-B palette       */
  82.   BYTE reserved;        /* Unused in Version 5                          */
  83.   BYTE nplanes;         /* Number of color planes                       */
  84.   WORD bppscan;         /* Number of bytes per plane scan line          */
  85.   WORD palette_type;    /* Palette interpretation                       */
  86.   WORD scrn_width;      /* Horizontal screen size in pixels             */
  87.   WORD scrn_height;     /* Vertical screen size in pixels               */
  88.   BYTE filler[54];      /* Padding to fill out 128-byte header          */
  89.  
  90.   /* Notes:                                                             */
  91.   /*                                                                    */
  92.   /*   1.  The "version" member may be one of the following:            */
  93.   /*                                                                    */
  94.   /*         0 - PC Paintbrush Version 2.5                              */
  95.   /*         2 - PC Paintbrush Version 2.8 (with palette information)   */
  96.   /*         3 - PC Paintbrush Version 2.8 (w/o palette information)    */
  97.   /*         4 - PC Paintbrush for Windows (PC Paintbrush Plus for      */
  98.   /*             Windows and Windows 3.0 Paintbrush use Version 5)      */
  99.   /*         5 - PC Paintbrush 3.0 and greater (including PC Paintbrush */
  100.   /*             Plus and Publisher's Paintbrush)                       */
  101.   /*                                                                    */
  102.   /*   2.  ZSoft Corporation has reserved the right to change the       */
  103.   /*       encoding method in future versions for better image          */
  104.   /*       compression performance.  The "encoding" member value may    */
  105.   /*       change accordingly.                                          */
  106.   /*                                                                    */
  107.   /*   3.  The value of the "bppixel" member depends on the type of     */
  108.   /*       video display adapter and its video mode.  Typical values    */
  109.   /*       are 1, 2, 4 and 8.                                           */
  110.   /*                                                                    */
  111.   /*   4.  The "xul", "yul", "xlr" and "ylr" members are zero-based and */
  112.   /*       and inclusive values indicating the position of the image on */
  113.   /*       the screen.  The display functions can ignore this           */
  114.   /*       information if desired.                                      */
  115.   /*                                                                    */
  116.   /*   5.  The "horz_res" and "vert_res" members refer to the "dots per */
  117.   /*       inch" resolution of the scanning device used to create the   */
  118.   /*       image.  For images created on video display adapters, these  */
  119.   /*       values typically refer to the horizontal and vertical        */
  120.   /*       resolutions in pixels (e.g. - 640 x 350 for an EGA display). */
  121.   /*                                                                    */
  122.   /*       The display function ignore these members, as some programs  */
  123.   /*       programs do not bother to initialize them when creating PCX  */
  124.   /*       image files.                                                 */
  125.   /*                                                                    */
  126.   /*   6.  The "palette" member is typically left uninitialized if an   */
  127.   /*       extended 256-color palette is appended to the PCX image      */
  128.   /*       file.                                                        */
  129.   /*                                                                    */
  130.   /*   7.  The "reserved" member used to contain the MS-DOS video mode  */
  131.   /*       that the PCX image was intended to be displayed under.  This */
  132.   /*       member is ignored in Version 5.  ZSoft recommends that it be */
  133.   /*       set to zero.                                                 */
  134.   /*                                                                    */
  135.   /*   8.  The value of the "nplanes" member depends on the type of     */
  136.   /*       video display adapter and its video mode.  Typical values    */
  137.   /*       are 1, 2, 3 and 4.                                           */
  138.   /*                                                                    */
  139.   /*   9.  The value of the "bppscan" member should be an even number   */
  140.   /*       (for compatibility with some existing commercial programs.)  */
  141.   /*       It indicates the number of bytes required to buffer a        */
  142.   /*       decoded scan line for one color plane.                       */
  143.   /*                                                                    */
  144.   /*  10.  The "palette_type" member indicates whether the palette      */
  145.   /*       represents a color or grayscale palette.  It is a bit-mapped */
  146.   /*       variable (only the lowest two bits are significant; the      */
  147.   /*       others are ignored) with two possible values:                */
  148.   /*                                                                    */
  149.   /*         0x01 - color or black & white                              */
  150.   /*         0x02 - grayscale                                           */
  151.   /*                                                                    */
  152.   /*       If "grayscale" is indicated, the file color palette must be  */
  153.   /*       set to shades of gray.  The file decoding functions can then */
  154.   /*       either use this palette or assume a default grayscale        */
  155.   /*       palette if necessary.                                        */
  156.   /*                                                                    */
  157.   /*       PC Paintbrush IV and IV Plus ignore this member.             */
  158.   /*                                                                    */
  159.   /*  11.  The "scrn_width" and "scrn_height" members were added for    */
  160.   /*       PC Paintbrush IV Version 1.02 and IV Plus Version 1.0.  They */
  161.   /*       may not be initialized in some older Version 5 PCX files, or */
  162.   /*       the "scrn_width" member may be initialized with the screen   */
  163.   /*       height and the "scrn_height" member uninitialized.  ZSoft    */
  164.   /*       recommends that this information be ignored.                 */
  165.   /*                                                                    */
  166.   /*  12.  ZSoft recommends that the "filler" bytes be set to zero.     */
  167. }
  168. PCX_HDR;
  169.  
  170. typedef struct pcx_workblk      /* PCX image file workblock             */
  171. {
  172.   /* File header                                                        */
  173.  
  174.   FILE *fp;                     /* PCX image file pointer               */
  175.   PCX_HDR header;               /* PCX image file header                */
  176.   PCX_PAL *palettep;            /* Color palette pointer                */
  177.   BOOL epal_flag;               /* Extended color palette flag          */
  178.  
  179.   /* Image manipulation variables                                       */
  180.  
  181.   int num_bytes;                /* Number of bytes to display           */
  182.   int mask;                     /* Unseen pixels mask                   */
  183.   unsigned long page_offset;    /* Display page address offset          */
  184.  
  185.   /* Image manipulation function pointer                                */
  186.  
  187.   void (*pcx_funcp)(struct pcx_workblk *, unsigned char _far *, int);
  188. }
  189. PCX_WORKBLK;
  190.  
  191. /* FUNCTIONS PROTOTYPES                                                 */
  192.  
  193. extern BOOL pcx_close(PCX_WORKBLK *);
  194.  
  195. extern PCX_WORKBLK *pcx_open(char *, BOOL);
  196.  
  197.